home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / strcpy.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  44 lines
  1.  
  2. STRCPY(3)                  UNIX Programmer's Manual                  STRCPY(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrccppyy - copy strings
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttrriinngg..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      ssttrrccppyy(_c_h_a_r _*_d_s_t, _c_o_n_s_t _c_h_a_r _*_s_r_c)
  12.  
  13.      _c_h_a_r _*
  14.      ssttrrnnccppyy(_c_h_a_r _*_d_s_t, _c_o_n_s_t _c_h_a_r _*_s_r_c, _s_i_z_e___t _l_e_n)
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      The ssttrrccppyy() and ssttrrnnccppyy() functions copy the string _s_r_c to _d_s_t (includ-
  18.      ing the terminating `\0' character).
  19.  
  20.      The ssttrrnnccppyy() copies not more than _l_e_n characters into _d_s_t, appending
  21.      `\0' characters if _s_r_c is less than _l_e_n characters long, and _n_o_t termi-
  22.      nating _d_s_t if _s_r_c is more than _l_e_n characters long.
  23.  
  24. RREETTUURRNN VVAALLUUEESS
  25.      The ssttrrccppyy() and ssttrrnnccppyy() functions return _d_s_t.
  26.  
  27. EEXXAAMMPPLLEESS
  28.      The following sets ``chararray'' to ``abc\0\0\0'':
  29.  
  30.            (void)strncpy(chararray, "abc", 6).
  31.  
  32.      The following sets ``chararray'' to ``abcdef'':
  33.  
  34.            (void)strncpy(chararray, "abcdefgh", 6);
  35.  
  36. SSEEEE AALLSSOO
  37.      bcopy(3),  memccpy(3),  memcpy(3),  memmove(3)
  38.  
  39. SSTTAANNDDAARRDDSS
  40.      The ssttrrccppyy() and ssttrrnnccppyy() functions conform to ANSI C3.159-1989 (``ANSI
  41.      C'').
  42.  
  43. 4th Berkeley Distribution        June 29, 1991                               1
  44.